Migration depuis une autre forge Gitlab
Procédure complète de migration d'un groupe GitLab depuis gitlab.irstea.fr vers forge.inrae.fr en utilisant le transfert direct de groupe.
Cette procédure permet de migrer tous les projets contenus dans un groupe. Si certains de vos projets sont encore rattachés à votre compte personnel, déplacez-les d’abord dans un groupe afin de faciliter la migration.
Prérequis
Accès & droits
- Compte Owner du groupe source sur gitlab.irstea.fr
- Compte Owner du groupe cible (avec le même nom si possible) sur forge.inrae.fr
Informations nécessaires
- URL de l'instance source : https://gitlab.irstea.fr/
- Un Personal Access Token (PAT) sur gitlab.irstea.fr avec permissions Owner ainsi que les scopes
apietread_repository
Étapes de migration
1. Créez un Token d'accès sur gitlab.irstea.fr
Allez dans les Settings du groupe puis Access Tokens, créez un token avec le rôle Owner et les scopes api et read_repository et copiez ce token (visible une seule fois).
2. Déclenchez l'import sur forge.inrae.fr
- Connectez-vous à https://forge.inrae.fr
- Menu Groups à gauche
- Bouton New group
- Bouton Import group
- Sectionnez Import groups by direct transfer
3. Configurez l'instance source
- GitLab source instance base URL : https://gitlab.irstea.fr/
- Personal access token : collez le token ici
- Cliquez sur Connect instance
4. Sélectionnez le groupe à migrer
Après connexion, les groupes apparaissent :
- Cochez le groupe source (exemple : opt)
- Définissez le chemin du groupe cible si celui-ci est différent
5. Lancez l'import
Le statut passe de Not started à In progress puis Finished.
🧪 Vérifications post-migration
| Élément | Vérification |
|---|---|
| Projets | Tous visibles & correctement clonables |
| Issues | Migrées |
| Merge requests | Migrées |
| Wiki | Migré |
| CI/CD Pipelines | Historique importé mais jobs non exécutés |
| Runners | À reconfigurer |
| Variables CI/CD | Vérifier / recréer manuellement si masquées |
| Container Registry | Vérifier images |
Points d'attention
| Composant | Comportement |
|---|---|
| Artifacts | Non migrés |
| CI schedules | A reconfigurer |
| Group runners | A recréer |
| Access tokens | Non migrés |
Exemple d'erreur possible si le volume du repository dépasse les 10GO
Une fois que tout fonctionne coté Forge INRAE, n'oubliez pas d'archiver le projet coté Gitlab IRSTEA afin que l'on puisse suivre la migration via le nombre de projets actifs restants.
